DC.destroy(boolKeepInternalContent)

Description: Destroys the current DC object.

Returns: Boolean: True if successful, false otherwise.

Note: If boolKeepInternalContent is false or undefined, or if the DC object is closed, destroy will clean and remove all internally stored DOM nodes associated with the DC object. If boolKeepInternalContent is true and the DC object remains open, all displayed content within the DC object will be preserved at its current location in the DOM before the associated DC object is destroyed.

If a function is declared for DC.beforeDestroy(), this handler will automatically be executed before the destroy process is performed.

Example:

DC.beforeDestroy = function(DC) {
  // Do something before the DC object is destroyed.
};

// Destroy the DC object.
DC.destroy();